home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 439_01 / readme.doc < prev    next >
Text File  |  1995-11-13  |  27KB  |  529 lines
  1. File Dated:  11/14/95
  2.  
  3. ******************************************************************************
  4. Quick Start with XLIB
  5. ******************************************************************************
  6.  
  7.    The user manual is largely dedicated to cover specifics of XLIB which 
  8. will not be of concern to many programmers.  A few notes are added here to
  9. expedite matters for these programmers.
  10.    If you are not an assembly language programmer, then consider using 
  11. EASYX rather than XLIB.  EASYX does not require use or knowledge of 
  12. assembly language.  The documentation for EASYX is in the file EASYX.DOC.
  13.    If you are familiar with assembly language, then start by reading the 
  14. file DONTREAD.ME.  This file is for those who don't particularly enjoy 
  15. reading 60 page user manuals.  It is an excellent tutorial.  You will 
  16. probably be ready to program with XLIB after working through the tutorial.
  17.    If your program is to be written exclusively in assembly language, then
  18. examine the files FLAT.INC and FLAT.ASM.  FLAT.INC is an include file which
  19. enables flat-model programming in DOS.  FLAT.ASM illustrates usage of
  20. FLAT.INC.
  21.  
  22. ******************************************************************************
  23. Frequently Encountered Problems When Starting XLIB
  24. ******************************************************************************
  25.  
  26.    The most frequently reported problem with XLIB is in fact no problem at
  27. all.  XLIB presents a registration reminder message when terminating.  Some 
  28. interpret this message as meaning that the shareware version of XLIB is 
  29. disabled.  This is not the case.  The shareware version is fully 
  30. functional.  You must register XLIB to obtain a copy of the library that 
  31. does not present the message.
  32.    The registration reminder message is actually a confirmation that XLIB
  33. has been initiated and terminated successfully.  If this message doesn't 
  34. appear in the shareware version, then the main program almost certainly has
  35. a bug preventing clean termination.
  36.    The second most frequently reported problem is by assembly language
  37. programmers who find that attempts to initialize XLIB (with INITXLIB) fail
  38. for lack of DOS memory.  MASM programmers must remember to link with the
  39. CPARM:1 parameter.  TASM programmers must resize the memory block into
  40. which DOS loaded the program (see EXAMP1B.ASM).
  41.  
  42. ******************************************************************************
  43. Improvements in XLIB Version 5.1 Over Version 5.0
  44. ******************************************************************************
  45.  
  46. 1) FLAT.INC and PMIO.INC contained statements which assumed the presence 
  47.    of a floating point unit.  These files have been generalized under 
  48.    version 5.1.
  49.  
  50. 2) PMXLOAD did not limit file loads to the size of the destination memory
  51.    block.  This bug has been fixed in version 5.1.
  52.    
  53. ******************************************************************************
  54. Registering XLIB
  55. ******************************************************************************
  56.  
  57.    XLIB may be registered for $50.  Registrants will be sent a registered
  58. copy of the XLIB archive along with a printed copy of the user manual.
  59. Technical support is provided for both registered and unregistered users;
  60. however, if you have used technical support or intend to use it, then the
  61. registration fee is $70.
  62.  
  63. There are four ways to register XLIB.  We prefer that you use one of the
  64. first two methods:
  65.  
  66. 1) By email using MasterCard or Visa:
  67.  
  68.    Edit the form in the file EMAIL.REG then email the file to TechniLib.
  69.  
  70. 2) By mail to TechniLib:
  71.  
  72.    Send check or money order along with return address to:
  73.  
  74.    TechniLib Company
  75.    P.O. Box 6818
  76.    Jackson, Ms 39282
  77.    USA
  78.  
  79.    Please write "XLIB" on check or include an explanatory note.  An email 
  80. address would also be appreciated.
  81.  
  82. 3) By credit card through Public (software) Library:
  83.  
  84.    You can order with MC, Visa, Amex, or Discover from Public (software)
  85. Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398
  86. or by CIS email to 71355,470.  You can also mail credit card orders to PsL
  87. at P.O.Box 35705, Houston, TX 77235-5705.  The product ID for XLIB is 11077.
  88.  
  89.    THE ABOVE NUMBERS ARE FOR ORDERS ONLY.  Any questions about the status of 
  90. the shipment of the order, refunds, registration options, product details, 
  91. technical support, volume discounts, dealer pricing, site licenses, etc, 
  92. should NOT be directed to PsL.  Direct all such questions to TechniLib.
  93.  
  94. 4) Through CompuServe:
  95.    
  96.    Use GO SWREG (shareware registration).  The program identification number 
  97. is 1778.  The program title is XLIB 5.1.
  98.  
  99.  
  100.    XLIB may be registered for $50.  Registrants will be sent a registered
  101. copy of the XLIB archive along with a printed copy of the user manual.
  102. Technical support is provided for both registered and unregistered users;
  103. however, if you have used technical support or intend to use it, then the
  104. registration fee is $70.
  105.  
  106. ******************************************************************************
  107. Obtaining the Most Recent Version of XLIB
  108. ******************************************************************************
  109.  
  110.    The most recent version of XLIB may be downloaded from:
  111.  
  112. 1) CompuServe - GO MSLANG or GO BCPPDOS then choose ASSEMBLER.
  113. 2) Internet -   oak.oakland.edu under directory \simtel\msdos\c
  114.  
  115.    Expect the archive to be named either XLIBvv.ZIP or DXLIBvv.ZIP where
  116. vv denotes the version number.
  117.    Keywords for XLIB include:  XMS, DPMI, VCPI, DOS, EXTENDER, PROTECTED
  118. MASM, TASM, TECHNILIB.
  119.  
  120. ******************************************************************************
  121. Communicating with TechniLib Via Electronic Mail
  122. ******************************************************************************
  123.  
  124.    You can communicate with TechniLib via CompuServe or Internet electronic 
  125. mail.  Direct CompuServe mail to user ID: 74730,167.  Internet users should
  126. use the address: 74730.167@compuserve.com.  Internet users may also send
  127. mail to davidpyles@delphi.com.
  128.  
  129. ******************************************************************************
  130. Instructions for Constructing Protected-Mode Libraries for Microsoft
  131. ******************************************************************************
  132.  
  133.    The following batch file uses Microsoft LIB to combine an OBJ file with
  134. XLIB.LIB to produce a protected-mode library.  Call the batch file using the
  135. base name of the OBJ file as the argument.  This base name will also be 
  136. given to the library.  It is assumed that the OBJ file and XLIB.LIB are in 
  137. the current directory.  LIB.EXE is assumed to be in the ..\BIN directory.
  138.  
  139. @echo on
  140. del %1.lib
  141. ..\bin\lib %1.lib /noi +%1.obj+xlib.lib;
  142.  
  143.    The following batch file uses Microsoft LINK and LIB to combine an OBJ
  144. file with XLIB.LIB to produce a protected-mode library and quick library for
  145. Microsoft BASIC 7.0.  Call the batch file using the base name of the OBJ
  146. file as the argument.  This base name will also be given to the library and
  147. the quick library.  It is assumed that all files apart from LINK.EXE and
  148. LIB.EXE are in the current directory.  The current directory must also
  149. contain the file QBXQLB.LIB (included in the BASIC distribution disks).
  150. LINK.EXE and LIB.EXE are assumed to be in the ..\BIN directory.
  151.  
  152. @echo on
  153. del %1.qlb
  154. del %1.lib
  155. ..\bin\link /q/nopackf xlib.lib+%1.obj,%1.qlb,,qbxqlb.lib;
  156. ..\bin\lib %1.lib +xlib.lib+%1.obj;
  157.  
  158.    The following command may be used to create a quick library from 
  159. EASYX.LIB.  The quick library is called EASYX.QLB:
  160.  
  161. ..\bin\link /q/nopackf easyx.lib,easyx.qlb,,qbxqlb.lib;
  162.  
  163. ******************************************************************************
  164. Instructions for Constructing Libraries and Linking with Borland
  165. ******************************************************************************
  166.    
  167.    The following batch file uses TLINK to link an OBJ file from TASM with
  168. XLIBB.LIB to produce a DOS-extended executable.  The base name of the OBJ
  169. is supplied as an argument to the batch file.  The executable will be given 
  170. the same base name as the OBJ file.  It